Skip to content

docs(appsflyer): document all report kinds and the quota reset - #22213

Merged
jakesciotto merged 1 commit into
masterfrom
docs/appsflyer-tables-and-quota
Nov 12, 2026
Merged

jakesciotto merged 1 commit into
masterfrom
docs/appsflyer-tables-and-quota

Conversation

@jakesciotto

@jakesciotto jakesciotto commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Changes

The AppsFlyer source page lists three aggregate tables and says that all tables sync incrementally on date. That statement is wrong. The connector has 17 tables in three report kinds, and each kind has its own incremental field and history window. This PR corrects the page and completes the quota troubleshooting from #22209.

  • Remove the hand-written table. The <SourceTables /> component at the bottom of the page already lists all 17 tables from the live source config.
  • Add a section for each report kind:
    • Aggregate reports: incremental on date, about 1,000 days of history, the last 2 days fetched again.
    • Raw data reports: incremental on event_time, the last 90 days, 7-day request windows, the last 7 days fetched again.
    • Master API report: incremental on install_time, 365 days of history, 31-day windows, the last 31 days fetched again.
  • Document that post_attribution_installs has no incremental field and reads the full 90-day window on each sync.
  • Document the AppsFlyer limit of 1,000,000 rows for each raw data request. AppsFlyer drops the rows above the limit without an error.
  • State that the quotas reset at 00:00 UTC, and link to the AppsFlyer quota page.
  • Document the "AppsFlyer rejected the report request" sync error. PostHog does not retry it, and a used-up quota can cause it.
  • State that the raw data, Master API, and Protect360 tables need a subscription that includes them, and that the Protect360 tables start unselected.

Sources

  • Tables, incremental fields, windows, and the row cap: products/warehouse_sources/sources/appsflyer/settings.py and appsflyer.py on posthog master.
  • Error messages and retry behavior: appsflyer/source.py (get_non_retryable_errors) and appsflyer.py (_open_report).
  • Live tables: https://us.posthog.com/api/public_source_configs lists the same 17 tables with release status ga.
  • Quota reset: the AppsFlyer report generation quotas page states "Quotas apply per calendar day, starting at 00:00 UTC."
  • Row cap: the AppsFlyer Pull API raw data page states "If a report has exactly 200K/1M rows, then assume rows are missing."

Validation

  • Vale: 0 errors, 0 warnings, 0 suggestions.
  • markdownlint-cli2 with the repository config: 0 errors.
  • scripts/check-source-release-callouts.js and git diff --check: passed.
  • I did not run the local dev server. I loaded the preview page in Chrome instead. The new sections, the table of contents, and all 17 rows of <SourceTables /> render.
  • The console shows React hydration errors Burger menu color fix #418 and Small fixes for pricing and free trial pages #423. The live page on posthog.com shows the same errors, so this change does not cause them.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json (not applicable: no page moved)

🤖 Generated with Claude Code

The AppsFlyer page lists three aggregate tables and says that all tables
sync incrementally on `date`. The connector has 17 tables in three report
kinds, and each kind has its own incremental field and history window.

- Remove the hand-written table. `<SourceTables />` already lists every
  table from the live source config.
- Document the sync behavior of the aggregate, raw data, and Master API
  reports, and of the full-refresh `post_attribution_installs` table.
- Document the 1,000,000-row cap for each raw data request.
- State the 00:00 UTC quota reset from the AppsFlyer quota page.
- Document the "rejected the report request" sync error, which PostHog
  does not retry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Nov 12, 2026
@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Nov 12, 2026 02:08AM

Changed pages

Page Source
Linking AppsFlyer as a source contents/docs/data-pipelines/sources/appsflyer.md

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

12.06 MiB (no change)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 10.41 MiB (no change) report-only 1100
Largest modules in the app closure
Module Size
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 1022.3 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules 287.2 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/SearchUI/index.tsx + 87 modules 273.1 KiB
./gatsby-browser.tsx + 59 modules 259.3 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-1.mjs 248.5 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 240.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-2.mjs 228.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 221.7 KiB
./src/hooks/useProducts.tsx + 23 modules 153.9 KiB
./src/hooks/skills.tsx + 2 modules 150.7 KiB
./src/hooks/useProduct.ts + 9 modules 149.8 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@jakesciotto
jakesciotto merged commit c2a5f9e into master Nov 12, 2026
23 checks passed
@jakesciotto
jakesciotto deleted the docs/appsflyer-tables-and-quota branch November 12, 2026 02:20
@github-project-automation github-project-automation Bot moved this from New to Done in PostHog.com planning Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content PR only touches files under contents/ docs Improvements or additions to product documentation, "Docs"

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant